package fragments.demo;

import android.app.Activity;
import android.app.Fragment;
import android.app.FragmentManager;
import android.app.FragmentTransaction;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;

public class ManagerFragmentActivity extends Activity {
	
	/**
	 * 		管理Fragment， 需要使用FragmentManager对象，我们可以使用 activity的getFragmentManager() 方法获取它
	 * 
	 *		这个对象能干些什么呢？
	 *		1. 通过getFragmentById()(用于有UI的Fragment)或getFragmentByTag()(有或没有UI的Fragment都可以使用) 获取当前Activity中存在的Fragment.
	 *		2. 使用popBackStack() 将Fragment从后台堆栈中弹出(模拟按下BACK键)
	 *		3. 使用addOnBackStackChangeListener注册一个监听后台堆栈变化的Listener。
	 */
	
	private TextView textViewShowResult = null;
	private Button btnGetFragment = null;
	private Button btnFragmentTransacation = null;
	private FragmentManager fragmentManager = null;

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		//首先使用FragmentTransaction对象将Fragment加入到当前的Activity中。在来管理这个Fragment。
		fragmentManager = this.getFragmentManager();
		//获得FragmentTransaction对象
		FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
		//将Fragment添到指定的区域
		//fragmentTransaction.add(R.id.listFrame, new ArticleListFragment());
		//fragmentTransaction.add(R.id.viewerFrame, new ArticleReaderFragment());
		fragmentTransaction.add(R.id.listFrame, new ArticleListFragment(), "listFragment");
		fragmentTransaction.add(R.id.viewerFrame, new ArticleReaderFragment(), "viewerFragment");
		//提交
		fragmentTransaction.commit();
		
		setContentView(R.layout.manager_fragment);
		
		textViewShowResult = (TextView)this.findViewById(R.id.textViewShowResult);
		btnGetFragment = (Button)this.findViewById(R.id.btnGetFragment);
		btnFragmentTransacation = (Button)this.findViewById(R.id.btnFragmentTransacation);
		
		btnGetFragment.setOnClickListener(new ButtonGetFragmentListener());
		btnFragmentTransacation.setOnClickListener(new ButtonFragmentTransacationListener());
	}

	class ButtonGetFragmentListener implements View.OnClickListener {
		public void onClick(View v) {
			//根据Tag获取当前Activity中的Fragment
			Fragment listFragment = fragmentManager.findFragmentByTag("listFragment");
			
			int listFragmentID = listFragment.getId();
			String listFragmentTag =  listFragment.getTag();
			
			// 获取Fragment中TextView的内容
			TextView textView = (TextView) listFragment.getView().findViewById(R.id.textViewList);
			textViewShowResult.setText("List fragment id is :" + listFragmentID + " List fragment tag name is :" + listFragmentTag + "TextView content is :" + textView.getText().toString());
		}
	}

	/**
	 * 关于在activity中使用fragment的很强的一个特性是: 根据用户的交互情况,对fragment进行添加,移除,替换,以及执行其他动作.
	 * 提交给activity的每一套变化被称为一个事务, 可以使用在 FragmentTransaction 中的 API 处理.我们也可以保存每一个事务到
	 * 一个activity管理的back stack,允许用户经由fragment的变化往回导航(类似于通过activity往后导航).
	 * 
	 * 每一个事务都是同时要执行的一套变化.可以在一个给定的事务中设置你想执行的所有变化,使用诸如 add(), remove(), 和 replace().
	 * 然后, 要给activity应用事务, 必须调用 commit().
	 * 
	 * 在调用commit()之前, 你可能想调用 addToBackStack(),将事务添加到一个fragment事务的back stack. 这个back stack由activity
	 * 管理, 并允许用户通过按下 BACK 按键返回到前一个fragment状态.
	 *
	 * 举个例子, 这里是如何将一个fragment替换为另一个, 并在后台堆栈中保留之前的状态:
	 */
	class ButtonFragmentTransacationListener implements View.OnClickListener{
		
		public void onClick(View v) {

			//当执行一个移除fragment的事务时, 如果没有调用 addToBackStack(), 那么当事务提交后, 那个fragment会被销毁,并且用户不能导航回到它. 
			//有鉴于此, 当移除一个fragment时,如果调用了 addToBackStack(), 那么fragment会被停止, 如果用户导航回来,它将会被恢复.
			
			//记住：如果添加多个变化到事务(例如add()或remove())并调用addToBackStack(), 然后在你调用commit()之前的所有应用的变化会被作为
			//一个单个事务添加到后台堆栈, BACK按键会将它们一起回退. 
			//也就是说：beginTransaction() 与 commit() 之间的所有操作都属于一个单独的事务。
						
			//为什么吧articleListFragment 传入会有问题？
			//下面的例子将一个fragment替换为另一个并且在后台堆栈中保留之前的状态: replace事务被保存到了BackStack中 因此用户可以通过BACK回退事务回到前一个Fragment
			FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
			fragmentTransaction.replace(R.id.viewerFrame, new ArticleListFragment());
			fragmentTransaction.addToBackStack(null);
			fragmentTransaction.commit();
			
			fragmentTransaction = fragmentManager.beginTransaction();
			fragmentTransaction.replace(R.id.listFrame, new ArticleReaderFragment());
			fragmentTransaction.addToBackStack(null);
			fragmentTransaction.commit();

			// 上面replace作为两个事务被添加到BackStack中 需要安两次Back键才能恢复到最初状态。
			// 下面replace和remove作为一个事务被添加到BackStack中 只需按一次Back键就可以恢复到最初状体。

			//fragmentTransaction = fragmentManager.beginTransaction();
			//fragmentTransaction.replace(R.id.viewerFrame, new ArticleListFragment());
			//fragmentTransaction.remove(new ArticleListFragment());
			//fragmentTransaction.addToBackStack(null);
			//fragmentTransaction.commit();
			
			//实际上添加事务的顺序不重要,重要的是一下几点
			//1. 必须最后调用commit
			//2. 如果添加多个fragment到同一个容器，那么添加的顺序决定了它们在view 层级中显示的顺序
			//3. 调用 commit() 并不立即执行事务.恰恰相反, 它将事务安排排期, 一旦准备好, 就在activity的UI
			//    线程上运行(主线程).如果有必要, 无论如何, 你可以从你的UI线程调用 executePendingTransactions() 来立即执行由commit()提交的事务. 
			//	   但这么做通常不必要, 除非事务是其他线程中的job的一个从属.
			//4. 警告: 你只能在activity保存它的状态(当用户离开activity)之前使用commit()提交事务.
			
		}
	}
}
